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Foreword 

This Technical Specification (TS) has been produced by the 3^^ Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS -family covering the 3^^ Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management, as identified below: 

32.41 1 : "Performance Management (PM) Integration Reference Point (IRP): Requirements" 

32.412: "Performance Management (PM) Integration Reference Point (IRP): Information Service 

(IS)" 

32.413: "Performance Management (PM) Integration Reference Point (IRP): Common Object Request 

Broker Architecture (CORBA) Solution Set (SS)" 

32.415 "Performance Management (PM) Integration Reference Point (IRP): extensible Markup Language 

(XML) definitions" 

The present document is part of a set of TSs which describes the requirements and information model necessary for the 
Teleconmiunication Management (TM) of 3G systems. The TM principles and TM architecture are specified in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

A 3G system is composed of a multitude of Network Elements (NE) of various types and, typically, different vendors, 
which inter-operate in a co-ordinated manner in order to satisfy the network users' conmiunication requirements. 
Any evaluation of PLMN-system behaviour will require performance data collected and recorded by its NEs according 
to a schedule established by the EM. 

This aspect of the management environment is termed Performance Management. The purpose of any Performance 
Management activity is to collect performance related data, which can be used to locate potential problems in the 
network. 
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1 Scope 

The present document specifies the Information Service for the Performance Management Integration Reference Point 
(PM IRP) as it applies to the Itf-N. 

This IRP IS defines the semantics of operations (and their parameters) visible across the Itf-N in a protocol and 
technology neutral way. It does not define the syntax or encoding of the operations and their parameters. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3 GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 



[I] 3GPP TS 32.101: "Teleconmiunication management; Principles and high level requirements". 
[2] 3GPP TS 32.102: "Teleconmiunication management; Architecture". 

[3] ITU-T Reconmiendation X.721 (1992): "Information technology - Open Systems Interconnection - 

Structure of management information: Definition of management information". 

[4] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault management; Part 2: Alarm 

Integration Reference Point (IRP): Information Service (IS)". 

[5] 3GPP TS 32.312: "Teleconmiunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[6] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[7] 3GPP TS 32.401: "Telecommunication management; Performance Management (PM); Concept 

and Requirements". 

[8] 3GPP TS 32.41 1 : "Telecommunication management; Performance Management (PM) Integration 

Reference Point (IRP): Requirements". 

[9] 3GPP TS 32.602: "Telecommunication management; Configuration Management (CM); Basic CM 

Integration Reference Point (IRP): Information Service (IS)". 

[10] 3GPP TS 32.342: "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP): Information Service (IS)". 

[II] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 
convention for Managed Objects". 

[12] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[13] Void. 

[14] 3GPP TS 32.40x: "Telecommunication management; Performance Management (PM)". 

[15] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 
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3 Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions defined in 3GPP TS 32.41 1 [8] and 
3GPPTS 32.401 [7] apply. 



3.2 Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



CM 


Configuration Management 


CORBA 


Common Object Request Broker Architecture 


EM 


Element Manager 


IOC 


Information Object Class 


IRP 


Integration Reference Point 


NE 


Network Element 


NM 


Network Manager 


NRM 


Network Resource Model 


PM 


Performance Management 


PMIRP 


Performance Management Integration Reference Point 


UML 


Unified Modelling Language 
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4 System Overview 
4.1 System Context 

The general definition of the System Context for the present IRP is found in 3GPP TS 32.150 [15] subclause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in the two diagrams below. 



IRPManager 



NM 



Itf-N 



IRPAgent 



EM 




Notification IRP 
PM IRP 

File Transfer IRP 
Alarm IRP 



NEs 



Figure 4.1 : System Context A 




IRPAgent 



NE 



Notification IRP 
PM IRP 

File Transfer IRP 
Alarm IRP 



Figure 4.2: System Context B 



4.2 Compliance rules 



For general definitions of compliance rules related to qualifiers (Mandatory/Optional/Conditional) for operations, 
notifications and parameters (of operations and notifications) please refer to 3GPP TS 32.102 [2]. 



Void 
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6.1 



Information Object Classes (lOCs) 
Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [6], information object class, Top 


Top 


3GPP TS 32.622 [6], information object class, iRPAgent 


IRPAgent 


3GPP TS 32.312 [5], information object class, ManagedGenericIRP 


ManagedGenericIRP 


3GPP TS 32.602 [9], information object class, ManagedEntity 


ManagedEntity 


3GPP TS 32.302 [12], information object class, Notif icationiRP 


NotificationIRP 


3GPP TS 32.1 11-2 [4], information object class, AlarmiRP 


AlarmiRP 


3GPP TS 32.342 [1 0], information object class, FileTransf eriRP 


FileTransferIRP 



6.2 Class diagram 

6.2.1 Attributes and relationships 

This clause introduces the set of Information Object Classes (lOCs) that encapsulate information within the 
IRPAgent. The intent is to identify the information required for the PMIRP Agent implementation of its operations 
and notification emission. This clause provides the overview of all support object classes in UML. Subsequent clauses 
provide more detailed specification of various aspects of these support object classes. 



«lnformationObjectGlass» 
JobMeasurementSchedule 



<lnformationObjectGlass» 
PMIRP 



+ jobSchedule 
+ jobStartTime 
+ jobStopTime 



rel at ion pmRP 



+thePMIRP 



-me asureme ntJobList 



+theJobSchedule ^ 
relation-measurementJob-^obMeasurementSchedule 

+th e M easu re m e n t Jo b 



«lnformationObjectGlass» 
MeasurementJobList 



+theMeasurement Jo bList 

relation-measurementJobList-measurementJob 



<lnformationObjectGlass» 
MeasurementJob 



■ jobListId 



-o 

+theMeasurementJobList 



+ jobid 
^> + jobGranularityPeriod 
0..n + jobReportingPeriod 
+theMeasurementJob +jobStatus 



1 

+theMeasurementJob 

relation-measurementJpb-measurement 

+theMeasurement 
1..n 

<lnformationObjectGlass» 
MeaajrementReader 



- measurementResultValue 



«lnformati onObjectGlass» 
Measured Attribute 



relation-measuredAttfibute-managedEntity 



- measurementTypeName 



«ProxyGlasB» 
ManagedEntity 



Figure 6.2.1(a): Information Object Class UML Diagram - Measurement 
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«lnfonnationObjectClass» 
Thresh old Level 



+ threshold Value 
+ thresholdSeverity 
+ hysteresis 



1..4 



/\ 



«lnformationObjectClass» 
PMIRP 



+thePMIRP 



relation-pmlRP-thtesholdMonitorList 



\/ 



+theThresholdMonitorList 



«lnformationObjectClass» 
ThresholdMonitorLlst 



+ monitorLlstid 



0..n 



+theThresholdMonitorList 



relation-thresholdMonitorList-thresholdMonitor 



\/ 



+theThreshold Monitor 



«lnformationObjectClass» 
ThresholdMonitor 



+ thresholdMonitorStatus 



+theThreshold Monitor 



relation-thresholdMonitor-measurement 



1..n 



+theThreshold Level 



relation-measured Attnbute-thresholdLevels 



+theMeasu red Attribute 



\/ +theMeasurement 



«lnformationObjectClass» 
MeasurementReader 



+ measurementResultValue 
+ probableCause 
+ specificProblem 
+ direction 



«lnformationObjectClass» 
Measured Attribute 



+ measurementTypeName 



relation -measure dA ttrib ute-managedEn tity 



1..n 



— >[ 
1..n 



«ProxyClass» 
ManagedEntity 



Figure 6.2.1(b): Information Object Class UML Diagram - Thresholding 
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Figure 6.2.1(c): Information Object Class UML Diagram - Combined 
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<lnformation Object Class» 
ManagedGenericIRP 

(from TS 32.312) 



«lnformationObjectClass» 
PMIRP 



«lnformation Object Class» 
Monitor 



■ monitorld 

■ monitorGranularityPeriod 




clnformationObjectClass» 
Top 

(fromTS 32.622) 

objectClass 
objectlnstance 




<lnformationObjectClass» 

MeasurementJobList 
- jobListId 



;<lnformationObjectClass» 

ThresholdMonitor 
h thresholdMonitorStatus 



«lnformationObjectCla 

MeasurementJob 
+ jobid 

+ jobGranularityPeriod 
+ jobReportingPeriod 
+ jobStatus 



«lnformationObjectClass» 
JobMeasurementSchedule 
+ jobSchedule 
+ jobStartTime 
+ jobStopTime 



« I n f rm ati n Obj ectCI ass» 

MeasuredAttribute 
+ measurementTypeName 



«lnformationObjectClass» 

MeasurementReader 
+ measurementResultValue 
+ probableCause 
+ specificProblem 
+ direction 



Figure 6.2.2: Information Object Class Inheritance UML Diagram 
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6.3 Information Object Class (lOCs) definitions 

6.3.1 MeasurementJob 
6.3.1.1 Definition 

It represents a task that monitors and collects the performance measurement data, i.e. values of multiple 
measurementTypes of multiple ManagedEntity instances, at regular time intervals defined in 
JobMeasurement Schedule. 

The target measurementTypes are those measurementTypes, whose names are in the related MeasuredAttribute . 
measurement TypeName, of the related ManagedEntity instances. The attributes of MeasurementJob, 
JobMeasurement Schedule and MeasuredAttribute can not be modified (except jobStatus) once a 
measurement job is created. 

The MeasurementJob shall use its information and the information of the related JobMeasurementSchedule 
and the information of MeasuredAttribute(s) to perform measurement data collection during the 
MeasurementJob life-time. At the time of data collection, if Measurement Job suspects the validity of the 
collected monitored values, the MeasurementJob should convey the fact to the IRPManager using the suspectFlag 
(3GPP TS 32.401 [7]) of the Report. The MeasurementJob will not emit any notification about this fact. 
Furthermore, the MeasurementJob shall continue to monitor the same target measurementTypes. Even in the worst 
possible case when the MeasurementJob cannot collect a single value from the target measurementTypes, the 
MeasurementJob must continue its activities according to the schedule created at MeasurementJob creation 
time. 

The PMIRP Agent may decide to stop a MeasurementJob because of a PMIRP Agent internal problem or other 
problems such as in the case when the related managed resource is not accessible (e.g. uninstalled) or there exist a 
prolonged communication link problem between the PMIRP Agent and the related managed resource. In such case, the 
PMIRP Agent can stop the MeasurementJob resulting in the MeasurementJob . j obStatus == "Stopped". 
Additionally, " notifyMeasurementJobStatusChanged" notification shall be emitted to notify all subscribed 
IRPManagers about the stopping of a MeasurementJob. 

The PMIRP Agent may also selectively suspend one or more MeasurementJobs without any operator" s action in case of 
overload. In such case, the PMIRP Agent suspends all the chosen MeasurementJob(s) resulting in the 
MeasurementJob .jobStatus == 'Suspended' and emit 'notifyMeasurementJobStatusChanged' notification for each 
MeasurementJob to notify all subscribed IRPManager(s) about the suspension. The behaviour on threshold monitors of 
PMIRP Agent after suspending is the same as the one after calling suspendMeasurementJob. 

Then it should be possible, at any time, for the operator to resume a MeasurementJob suspended by the system. PMIRP 
agent may also resume the measurementJob by itself after detecting the end of the overload. When PMIRP Agent does 
not support the resumeMeasurementJob operation, PMIRP Agent shall resume the measurementJob automatically after 
detecting the end of overload. The behaviour of PMIRP Agent after resuming the measurementJob is the same as the 
one after calling resumeMeasurementJob. PMIRP Agent may suspend the corresponding measurementJob(s) when it can 
decide which one/ones cause(s) the overload; otherwise, PMIRP Agent can take jobPriority as a reference. The criterion 
for suspending one or another measurementJob of equal job priority is vendor specific. 

The way to detect the beginning and the end of overload is out of the scope of the present document. 



6.3.1.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


jobid 


+ 


M 


M 




j obGranularityPeriod 


+ 


M 


M 




j obReportingPeriod 


+ 


M 


M 




j obStatus 


+ 


M 


M 




j obPriority 


+ 





M 
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6.3.1.3 State diagram 



The measurement 
job is visible via Itf-N 



The measurement job is 
visible via Itf-N and not 
removed in IRPAgent 



create 



start^ime reached 
suspendMeasur^mei\itJob 




The measurement L 
job is removed in 
IRPAgent 



stopTime reached or 
stopMeasurementJob or 
stopped by system 



suspendMeasurementJob 
or suspended by system 



Figure 6.3.1.3.1 : State Diagram for MeasurementJob 



Active 



Busy 




Figure 6.3.1.3.2: SubState Diagram of Active 

The detailed description and state transition scenarios for MeasurementJob are in annex A. 
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6.3.2 JobMeasurementSchedule 



6.3.2.1 Definition 

JobMeasurementSchedule is the representation of the time intervals when the measurement job monitors and 
collects the performance measurement data. The attributes of JobMeasurementSchedule can not be modified 
once a measurement job is created. 



6.3.2.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


j obStartTime 


+ 


M 


M 




j obStopTime 


+ 


M 


M 




j obSchedule 


+ 


M 


M 





6.3.3 PMIRP 



6.3.3.1 Definition 

PMIRP is the representation of the performance management capabiUties specified by the present document. This IOC 
inherits from ManagedGenericIRP IOC specified in 3GPP TS 32.312 [5]. 

6.3.3.2 Attribute 

There is no additional attribute defined for this IOC besides those inherited. 



6.3.3.3 Notification 



^^^^^^^ Namf^ ^^^^^^^^^^^^ 


Qualifier 


Notes ^^^^ 


notif yMeasurement JobStatusChanged 


M 


See clause 7.6.1. 


notifyThresholdMonitorObj ect Great ion 


M (see note) 


See clause 7.7.1. 


notifyThresholdMonitorObj ectDeletion 


M (see note) 


See clause 7.7.2. 


notif yThresholdMonitorStatusChanged 


(see note) 


See clause 7.7.3. 


NOTE: This notification is defined witiiin the PI\/IIRPNotification_2 Interface (see clause 7.7) which is qualified as 


optional. 

If the Interface is supported, then the qualifier defined here is relevant. 
Otherwise, the qualifier is irrelevant. 





6.3.4 Measurement JobList 
6.3.4.1 Definition 

Measurement JobList is the representation of the list of Measurement Jobs. 



6.3.4.2 



Attributes 



j obListId 



Visibility 



sad Qualifier 



M 
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6.3.5 MeasuredAttribute 
6.3.5.1 Definition 

It represents the name of the measurementType of the related ManagedEntity instance whose value is to be 
monitored and collected. The name of the monitored and collected measurementType is captured by 
measurementTypeName. 



6.3.5.2 Attributes 



Attribute name 


Visibility 








measurementTypeName 


+ 


M 


M 





6.3.6 MeasurementReader 

6.3.6.1 Definition 

It represents the capability to read the value of the measurementType of the related ManagedEntity instance. 
The value of the monitored and collected measurementType is captured by measurementResultValue. 

6.3.6.2 Attributes 



Attribute name 


Visibility 




measurementResultValue 


+ 


M 


M 




probableCause 


+ 


M 


M 




specif icProblem 


+ 


M 


M 




direction 


+ 


M 


M 





6.3.7 ManagedEntity 
6.3.7.1 Definition 

The IOC ManagedEntity represents an IOC defined in Network Resources Models, e.g. Generic Network Resource 
Model, Core Network Resource Model, UTRAN Network Resource Model or GERAN Network Resource Model. It 
also can represent VSE subclass of 3GPP defined NRM lOCs or VSE defined NRM lOCs. Besides, it can also represent 
a 'private Object Class' as defined in TS 32.404, e.g. RA. ManagedEntity is used in the specification of PMIRP 
operations to represent an IOC defined in these Network Resource Models and private Object Classes. 



ETSI 



3GPP TS 32.412 version 7.1.0 Release 7 



19 



ETSI TS 132 412 V7.1.0 (2007-10) 



6.3.8 Monitor 
6.3.8.1 Definition 

It represents a capability to determine the (a) threshold-crossing or (b) threshold-reaching and the threshold-clearing. 
This class is abstract in that it cannot be instantiated. The ThresholdMonitor inherits this class. 

It is the IRP Agent" s choice to support (a) or (b) (but not both). The support is on an IRP Agent system wide basis and is 
not on a per threshold basis. The IRPAgent"s behaviour regarding which approach (i.e., (a) or (b) above) to use, shall be 
the same for emitting alarms and for clearing alarms. 

The instances of a class derived from this abstract class shall emit notifyThresholdMonitorObjectCreation when they 
are first created; and shall emit a notifyThresholdMonitorObjectDeletion when deleted. 

The instances of a class derived from this abstract class shall also emit notifyNew Alarm, notifyChangedAlarm and 
notifyClearedAlarm according to the rules specified in Annex B: Threshold Alarm Triggering Events. 
The objectClass and obj ect Instance parameter of these notifications carry the class and DN of the 
ManagedEntity whose measurement Type is being monitored and whose threshold condition has been triggered. 
The eventType of these notifications carry "Quality of Service Alarm". See 3GPP TS 32.111-2 [4]. 



6.3.8.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


monitorld 


+ 


M 


M 




monitorGranularityPeriod 


+ 


M 


M 





6.3.8.3 Notification 



■ Noti^^^^^^^^^^^^^H 


Note ^^^^^^^M 


notif yThresholdMonitorCreation 


See clause 7.1 (class diagram). 


notifyThresholdMonitorDeletion 


See clause 7.1 (class diagram). 



6.3.9 ThresholdMonitorList 

6.3.9.1 Definition 

ThresholdMonitorList is the representation of the list of ThresholdMonitors. 

6.3.9.2 Attributes 



monitorListId + M M 
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6.3.10 ThresholdMonitor 
6.3.10.1 Definition 

In order to monitor the overall health of the network, the thresholds are set by the authorized users to generate network 
performance related alarms. The ThresholdMonitor contains the values of the threshold settings for the PM 
parameters. If the threshold is (a) crossed or (b) reached (see 6.3.8.1 for clarification of the alternatives (a) and (b)), a 
performance alarm will be emitted (see 3GPP TS 32.401 [7]). The name of the monitored measurementType is captured 
by MeasuredAttribute . measurementTypeName and the value of it is captured by 
MeasurementReader . measurementResultValue. 



6.3.10.2 Attribute 













thresholdMonitorStatus 


+ 


M 


M 





6.3.11 ThresholdLevel 
6.3.11.1 Definition 

It defines the thresholding criteria (via ThresholdLevel . thresholdValue and 

ThresholdLevel . hysteresis) for a measurementType. It also specifies the thresholds everity level (via 
ThresholdLevel . thresholdSeverity) carried in the alarm triggered by the (a) threshold crossing or (b) 
threshold reaching event. (See 6.3.8.1 for clarification of the alternatives (a) and (b)). 



6.3.11.2 Attribute 













thresholdValue 


+ 


M 


M 




thresholdSeverity 


+ 


M 


M 




hysteresis 


+ 


M 


M 
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6.4 Information relationship definitions 

6.4.1 relation-pmlRP-measurementJobList (M) 

6.4.1.1 Definition 

This represents the relationship between PMIRP and Measurement JobList. 

6.4.1.2 Role 



Name ^^^^^^^H 


Definition ^^^^^^^^^^^^^^H 


theMeasurement JobList 


It represents the Measurement JobList. 


thePMIRP 


It represents the pmirp. 



6.4.1.3 Constraint 



Name 


Definition 


uniqueJobListId 


The jobListlds playing the role of theMeasurementJobList, are unique within a particular pmirp. 



6.4.2 reiation-measurementJobLlst-measurementJob (M) 

6.4.2.1 Definition 

This represents the relationship between Measurement JobList and Measurement Job. 

6.4.2.2 Role 



theMeasurement Job 


It represents the Measurement Job. 


theMeasurementJobList 


It represents the Measurement JobList. 



6.4.2.3 Constraint 



^^^^^^^^ 


Definition 


uniqueJobId 


The joblds of all Measurement Jobs, playing the role of theMeasurementJob, are unique within a 
particular pmirp and Measurement JobList. 



6.4.3 relation-measurementJob-jobMeasurementSchedule (M) 

6.4.3.1 Definition 

This represents the relationship between Measurement Job and JobMeasurementSchedule. 

6.4.3.2 Role 



Na^^^^^H 


^^^^^^^^^^^^^^^^^^ 


theJobSchedule 


It represents the JobMeasurementSchedule. 


theMeasurementJob 


It represents the Measurement Job. 
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6.4.4 relation-measurementJob-measurement (M) 
6.4.4.1 Definition 

This represents the relationship between Measurement Job and MeasurementReader. 



6.4.4.2 Role 







theMeasurement 


It represents the MeasurementReader. 


theMeasurement Job 


It represents the Measurement Job. 



6.4.5 relation-measuredAttribute-managedEntity (M) 

6.4.5.1 Definition 

This represents the relationship between MeasuredAttribute and ManagedEntity. 

6.4.5.2 Role 



^^^^^^^^^^^^^ 


Definition 


theMeasuredAt tribute 


The MeasuredAttribute, when playing this role, reads the monitored measurement 
types of the related ManagedEntity instances. The names of measurement types are 
captured by the MeasuredAttribute .MeasurementTypeName . When playing this 
role, the MeasuredAttribute Is aware of the class name and DN of the 

ManagedEnt i ty. 


theME 


The ManagedEntity, when playing this role, represents the actual network resource 
instance under measurement or whose measurementTypes are being monitored for (a) 
threshold-crossing or (b) threshold-reaching and threshold-clearing. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 



6.4.5.3 Constraint 







applyToSameObj ectClass 


The MeasuredAttribute, which playing the role of "theMeasuredAttribute", can 
monitor the thresholds of the measurementTypes of one or multiple managed object 
instances of the same managed object class, which playing the role of "theME". 
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6.4.6 relation-pmlRP-thresholdMonitorList (M) 

6.4.6.1 Definition 

This represents the relationship between PMIRP and ThresholdMonitorList. 

6.4.6.2 Role 



Name ^^^^^^^H 


^^^^^^^^^^^^^ 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 


thePMIRP 


It represents the pmirp. 



6.4.6.3 Constraint 



Name 


Definition ^ 


uniqueMonitorListId 


The monitorListlds playing the role of theThresholdMonitorList, are unique within a particular 

PMIRP. 



6.4.7 relation-thresholdMonitorList-thresholdMonitor (M) 

6.4.7.1 Definition 

This represents the relationship between ThresholdMonitorList and ThresholdMonitor. 

6.4.7.2 Role 







theThresholdMonitor 


It represents the ThresholdMonitor. 


theThresholdMonitorList 


It represents the ThresholdMonitorList. 



6.4.7.3 Constraint 



Name 


Definition 


uniqueMonitorld 


The monitorlds of all ThreshoidMonitors, playing the role of theThresholdMonitor, are unique 
within a particular ThresholdMonitorList. 



6.4.8 relation-thresholdMonitor-measurement (M) 

6.4.8.1 Definition 

This represents the relationship between ThresholdMonitor and MeasurementReader. 

6.4.8.2 Role 



^ Nfltne 


Definition 


theMeasurement 


It represents the MeasurementReader. 


theThresholdMonitor 


It represents the ThresholdMonitor. 
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6.4.9 relation-measuredAttribute-thresholdLevels (M) 
6.4.9.1 Definition 

This represents the relationship between MeasuredAttribute and ThresholdLevel. 



6.4.9.2 Role 



Namp 


Definition 


theMeasuredAt tribute 


The MeasuredAttribute, when playing this role, can have 1 ..4 ThresholdLevel 
associates with it to set the (a) threshold-crossing or (b) threshold reaching and the clearing 
criteria (i.e. ThresholdLevel . thresholdValue, ThresholdLevel . hysteresis) and 
associated thresholdSeverity (i.e. ThresholdLevel . thresholdSeverity) of the 
monitored measurementType. (see 6.3.8.1 for clarification of the alternatives (a) and (b)) 


theThresholdLevel 


When playing this role, the ThresholdLevel captures the (a) threshold-crossing or (b) 
threshold-reaching and the threshold-clearing criteria and its associated thresholdSeverity 
level, (see 6.3.8.1 for clarification of the alternatives (a) and (b)) 


6.4.9.3 Constraint 




Definition 


noMoreThanFourLeve 1 s 


A MeasuredAttribute may have no more than four ThresholdLevels associated with 
it. 
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6.5 Information attribute definition 



6.5.1 Definition and legal values 



Attribute 
Name 


Definition 


Legal Values 


directio 
n 


For Sonne nneasurennentType, the higher its 
thresholdValue, the higher is the 
thresholdSeverity. For others, the lower its 
thresholdValue, the higher is its 
thresholdSeverity. This attribute identifies if the 
measurennentType is of the fornner 
(i.e. "Increasing") or latter type (i.e. "Decreasing"). 
If it is "Increasing", the threshold event is 
triggered when the value first equals or exceeds 
(when compared against the last read value) a 
threshold value. The threshold is said to be 

oIqoi'q/H iA/k»£M^ m^ooi i r^mon+Tx/r^Q it^ folio 

cieareo wnen me Mieasuremeni i ype vaiue Tans 
below (when connpared against the last read 
value) one or nnore threshold values. 
If it is "Decreasing", the threshold event is 
triggered when the measurementType value first 
equals or falls below one or more threshold 
values. The threshold is said to be cleared when 
the measurementType value rises above the 
threshold value. 

See annex B (Threshold Related Performance 
Alarm Triggering Events) for details of the 
behaviour of multiple thresholds. 


Possible values are: "Increasing", "Decreasing" 


hysteres 
is 


A threshold has a value. It can have a hysteresis. 
A threshold with a hysteresis has a threshold-high 
ana a inresnoia-iow vaiue mat are ainerenT irom 
the threshold value. 

A hysteresis, therefore, defines the threshold-high 
and threshold-low levels within which the 
measurementType value is allowed to oscillate 
wiuiuui uiyyuiiiiy a \a) iiiicbiiuiu uiubbiiiy ui \U) 
threshold-reaching or a threshold-clearing 
condition. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 
threshold-high = threshold + hysteresis 
threshold-low = threshold - hysteresis 
See annex B (Threshold Related Performance 
Alarm Triggering Events). 


Any positive value 


j obGranu 
larityPe 
riod 


It specifies the period between two successive 
measurements. 


The value can be 5 minutes, 15 minutes, 30 minutes, 1 
hours, 12 hours and 24 hours. 
The minimum granularity period is 5 minutes in most 
cases, but for some measurements it may only make 
sense to collect data in a larger granularity period. 


jobid 


It identifies the Measurement Job instance (and 
distinguishes it from all other existing and stopped 
Measurement Job instances of the PMIRP 
Agent). 


Any identifier except: 

1 . Those that identify Measurement Job instances 
whose Measurement Job . j obStatus ( s ) are 
Scheduled, Active, Suspended or Stopped; and 

2. Those that appear in filenames of files ready for 
IRPManager retrieval. 


j obListI 
d 


It identifies the singleton Measurement JobList 
of the PMIRP Agent. 


Any identifier. 


j obRepor 
tingPeri 
od 


It specifies the period between two successive 
emissions of notifyFileReady or 
notifyFilePreparationError [10]. The two 
notifications are related to the same Job. See 
constraints reportTime in clause 6.5.2. 


Its value should be one or multiple of 
jobGranularityPeriod. 
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Attribute 
Name 


Definition 


Legal Values 


j obSched 
ule 


It specifies the detailed time frames during which 
the Measurement Job . j obStatus = Active and 
Its substate = Busy. 


Its value is only one of the following, dailyScheduling or 

weeklyScheduling. The legal values for them refer to ITU- 

T Recommendation X.721 [3]. 

The legal values for them are as follows. 

dailyScheduling: 

{{ intervalStart {hour 0, minute 0}, 
intervalEnd {hour 23, minute 59}}} 

weeklyScheduling: 
{{daysOfWeek 'lllllirB, 
intervalsOfDay dailyScheduling}} 


jobStart 
Time 


It specifies the begin time from which the 

Measurement Job will be active. 


All values that indicate valid timestamp. 


j obStatu 
s 


It specifies the status of Measurement Job. 


Its value should be one of the following: Scheduled, 

Active, 

Suspended 

Stopped 


j obPrior 
ity 


It specifies the priority of MeasurementJob 


Its value should be one of the following: 

Low, 

Medium, 

High 


jobStopT 
ime 


It specifies the end time after which the 
MeasurementJob will be Stopped. 


All values that indicate valid timestamp and it should be 
later than jobStartTime.lt's not necessary that 
jobStartTime and jobStopTime specifies time within the 
same day. 

This attribute may carry the value "indefinitely". 


measurem 
entResul 
tValue 


It identifies the value of a measurement type. 


Any valid measurement result value. 


measurem 
entTypeN 
ame 


It identifies a name of one measurement type 
whose value is being collected and monitored. 


Any valid measurement type name as defined by the 
measurement definition template in 3GPP TS 32.40x [14]. 


monitorG 
ranulari 
tyPeiriod. 


It specifies the period between two successive 
reading of the thresholdValue to determine (a) 
threshold-crossing or (b) threshold-reaching and 
threshold-clearing. (See 6.3.8.1 for clarification of 

11 ciiloi 1 icili voo ^d^ cii lU yU)) 


It can be 5 minutes, 15 minutes, 30 minutes, 1 hour, 12 
hours or 24 hours. 

It has to be a multiple of the jobGranularityPeriod if the 
MeasurementJob monitoring the same 
measuremeni i ype exisis. 


monitorl 
d 


It identifies the ThreshoidMonitor instance 
(and distinguishes it from all other existing 

ThreshoidMonitor instances Of the PMIRP 
Agent). 


Any identifier except those that are currently used. 


monitorL 
istid 


It identifies the singleton 

ThresholdMonitorList in the PMIRP Agent. 


Any identifier. 


probable 
Cause 


It identifies the probable cause (of the (a) 
threshold crossing or (b) threshold reaching) 
carried by the threshold crossing or reaching 
alarm. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 


"Threshold Crossed" 


threshol 
dSeverit 

y 


It identifies the thresholdSeverity of the (a) 
threshold crossing or (b) threshold reaching 
event. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 


Warning, Minor, Major, Critical 


specific 
Problem 


It identifies the specific problem (causing the (a) 
threshold crossing or (b) threshold reaching) 
carried by the threshold crossing or reaching 
alarm. (See 6.3.8.1 for clarification of the 
alternatives (a) and (b)) 


Any valid specificProblem as defined by 
3GPP TS 32.111-2 [4]. 


threshol 
dMonitor 
Status 


It specifies the current status of the 
ThreshoidMonitor. 


Active - ThreshoidMonitor is working; 
Suspended - ThreshoidMonitor is suspended. 
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Attribute 
Name 


Definition 


Legal Values 


threshol 
dValue 


It defines the threshold value of the monitored 
measurementTypes. If the value is (a) crossed or 
(b) reached, the performance alarm shall be 
emitted depending on the value of the 
thresholdMonitorStatus. (See 6.3.8.1 for 
clarification of the alternatives (a) and (b)) 


If the monitored measurementType is of Gauge type, this 
thresholdValue shall be of the same type. 
If the monitored measurementType is of counter type, 
then this value should be expressed as a rate, i.e., the 
number of units of type of the monitored 
measurementType over unit of time. 
Note this rate is independent from the 
monitorGranularityPeriod. This means that changes in the 
monitorGranularityPeriod should not impact the rate used 
for threshold monitoring. 


6.5.2 Constraints 









IT tne joDneporTingrerioa is n times tne joDLaranuiariiyrerioa, 
then the first report time shall be immediately after the 
completion of the n-th successful measurementType reading. 


measurementTypeReadTimes 


The measurementType reading times are determined by the 
following rules. 

- If jobGranularityPeriod is 5 minutes, then read on every 5^"^ 
minute of the hour. 

- If jobGranularityPeriod is 15 minutes, then read on every 
15^^ minute of the hour. 

- If jobGranularityPeriod is 30 minutes, then read on every 
30^^ minute of the hour 

- If jobGranularityPeriod is 1 hour, then read on every hour of 
the day 

- If jobGranularityPeriod is 12 hours, then the first read shall 
be as soon as possible on the hour and subsequent reads 
shall be at 12 hours interval. 

If jobGranularityPeriod is 24 hours, then the first read shall 
be as soon as possible on the hour and subsequent reads 
shall be at 24 hours interval. 


multiLevelSeverity Hys teres isOver lap 


For each ThresholdLevel . thresholdSeverity, there 
may be a ThresholdLevel . hysteresis value 
corresponding to it. These multi-level values of 
ThresholdLevel . hysteresis, relating tO one 
ThresholdMonitor, shall not Overlap. 


mult i Level Sever ityOrder 


The multiple ThresholdLevel (s) , related to one 
ThresholdMonitor, shall be of the following order. If 
ThresholdLevel . thresholdSeverity of one instance is 
higher than that of the other instance and the direction is 
'Increasing', then the ThresholdLevel . thresholdValue is 
higher than that of the other. If 

ThresholdLevel . thresholdSeverity of one instance is 
higher than that of the other instance and the direction is 
'Decreasing', then the ThresholdLevel . thresholdValue 
is lower than that of the other. 


numberOf ThresholdLevelPerThresholdMonitor 


In relation-tMonitor-tLevel, the multiplicity of 
theThresholdLevel is "1..4". 

If PMiRP supports multi-level thresholdSeverity, then there are 
at most 4 ThreshoidLeveis relating to one 

ThresholdMonitor. All 

ThresholdLevel . thresholdSeverity instances shall 
hold a different value that is chosen from the following: 'Critical', 
'Major', "Warning' and 'Minor'. 

If PMIRP does not support multi-level thresholdSeverity, then 
there is only one ThresholdLevel relating to one 

ThresholdMonitor. The sole 

ThresholdLevel . thresholdSeverity shall hold one Of 
the following: 'Critical', 'Major', "Warning' or 'Minor'. 
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7 Interface definition 
7.1 Class diagram 



<< In formationObjec tClass>> 
Notificat ion IR P 

(from TS 32.302) 



<< N otificatio n >> 
PMIRPNotifications_1 



<<agent-internal-usage>> 



<<agent-interhal-usage>> 



<<Notification>> 
PM IRP Notifications_2 

n 1 ify Th re s h Id M n i to rS tat u s C h a n g e d 
notifyThres holdM onitorObjectCreationO 
notifyTh res hold M onitorObjectDeletionO 




<< Inte rface>> 
PMIRPOperations_1 

createMeasurementJobO 
stopMeasurementJobO 
suspendMeasurem entJob() 
resumeMeasurementJobO 
listMeasurem entJobs() 



<< Interface >> 
PMIR P0perations_2 



<<agent-JMernal-usage>> <<agen t-lnternaPus ag e>> 



<< Info rm ationObjectClass>> 
Alarm IRP 

(from TS 3 2.111) 



<<may us^>> 



< < lis e > > 



<<Notification>> 
Alarm IRP N otificatio ns_2 

(from TS 3 2.111) 



<< Notification>> 
A larm IRP Notification s_1 

(from TS 32.1 1 1 ) 



<< In form ationObjectClass>> 
FileTransferlR P 

(f ro m TS 32. 34 2) 



<< u/se> > 

<< N otificatio n >> 
File Trans ferlR PN otifocations_1 

(from TS 32.342) 



+ createThresholdMonitorO 
+ d e leteTh res h Id Mo n ito r() 
+ lis tTh res h Id Mo n ito rs 



<< lnterface>> 
PMIRPOperation_3 

s us p end Threshold Mo nitor() 
resum eThresholdMonitorO 



<< lnterface>> 
F il e Tr a n s fe rl R P Op e ra ti n s_ 1 

(f rom TS 32. 34 2) 



NOTE 1 : PMIRPNotifications_2 is mandatory if PI\/IIRPOperations_2 is supported. 

NOTE 2: The suspendlVleasurementJob and resumelVleasurementJob operations are optional. 



Figure 7.1 : Class Diagram 
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7.2 Generic rules 

- Rule 1: each operation with at least one input parameter supports a pre-condition vaHd_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

- Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 

- Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 

7.3 PMIRPOperations_1 Interface (M) 
7.3.1 Operation createMeasurementJob (M) 
7.3.1.1 Definition 

This operation supports IRPManager's request to create a Measurement Job through Itf-N. 

Once created, the attributes of Measurement Job (except Measurement Job . j obStatus) and the related 
JobMeasurementSchedule and MeasuredAttribute will not be modified during the life-time of the 
Measurement Job. 

One Measurement Job can collect the value of one or multiple measurementTypes. 

When a measurementType is collected by one Measurement Job for a given instance, another Measurement Job 
which wants to collect the same measurementType for the same instance with different or the same 
jobGranularityPeriod may be rejected. This behaviour shall be consistent for a given implementation by a specific 
vendor. 
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7.3.1 .2 Input parameters 



Parameter Name 


Qualif 
ier 


Information type 


Comment 


iOCName 


M 


ManagedEntity . o 
bj ectClass 


It specifies one Managed Entity class name. iRPManager requests 
that one or more measurementType(s) of the instances of this class to 
be monitored. 


iOCInstanceList 


M 


List of 

<]yianagedEntity . 
obj ectlnstance> 


It specifies the list of DNs of ManagedEntity instances whose 
measurementType(s) are to be collected. 

ManagedEntity instance(s) can be added in the network regardless 
of whether a Measurement Job exists or not. 

An empty list means that all instances known by pmirp shall be 
monitored. 

The support of the use of empty list to indicate all instances is 
optional. 

If the Measurement Job is created using empty list, there are two 
possible implementations: 

1) PMIRP shall monitor all instances known by PMIRP at the time of 
MeasurementJob creation, and it will not monitor instances added 
later. 

2) PMIRP shall monitor all instances known by PMIRP at the time of 
MeasurementJob creation, and it shall monitor instances added 
later. 


measurement Gate 
goryList 


M 


List of < 

MeasuredAttribu 
te. 

measurementType 

IN d [lie > 


MeasuredAttribute . MeasurementTypeName specifies the 
corresponding name of measurementType to be measured. 

The element of measurementCategoryList could be one of the 
following: 

- The form "family. measurementName.subcounter" can be used in 
order to retrieve a specified subcounter of a MeasurementType. 

The form "family.measurementName" can be used in order to 
retrieve a specific MeasurementType. In case the MeasurementType 
includes subcounters, all subcounters will be retrieved. 

- The form "family" can be used in order to retrieve all 
MeasurementTypes in this family. 

At least, one element of measurementCategoryList shall be specified. 


granular ityPeri 
od 


M 


Measurement Job . 

H r^lr^d'i^^ T^^^~\ ^^t^H 

J KJXJyJl. CtllU. J. Cti. J. U y It 

eriod 


See clause 6.5.1 (definition and legal values). 


report ingPeriod 


M 


Measurement Job . 

1 K-J IV ^ ^ K-J _L_ _L -1- 1 ^ -L ^ J_ 

iod 


See clause 6.5.1 (definition and legal values). 

FMIKF WIN pUl lUUlUdliy lllUilllUi lllU pUl lUi 1 1 Idi lUU Uald. d.UUUiUlliy lU lllU 

"reportingPeriod" parameter and produces an aggregated report in 
one or more files. These files shall be transferred through file transfer 
mecnariisrn covereu uy ine rue i ransTer irir lo \^see i o o^l.o^^^l [ \ ujj. 


startTime 





JobMeasurementS 
tTime 


See clause 6.5.1 (definition and legal values). 

ueiauiT vaiue is siari now . it siari i ime is in ine pasi, me curreni iime 
will be used and the job will start immediately. 


stopTime 





JobMeasurementS 
chedule . j obStop 
Time 


See clause 6.5.1 (definition and legal values). 

Default value for jobStopTime is to run indefinitely. StopTime shall be 

later than startTime and current time. 


schedule 





JobMeasurementS 
chedule . j obSche 
dule 


See clause 6.5.1 (definition and legal values). 
Default value is "daily". 


priority 





JobMeasurement J 
ob . j obPriority 


See clause 6.5.1 (definition and legal values). 
Default value is 'Medium' 
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7.3.1 .3 Output parameters 



Parame^^^Bie 


Qualifier 


Matching Informati^^H 


ComnHI^^H 


jobid 


M 


Measurement Job . j obid 


Unique identifier of the Measurement Job from 
all the existing and stopped Measurement Jobs 
in a PMiRP Agent. 


unsupportedList 


M 


List of < 

ManagedEntity . obj ect Instance, 
MeasuredAttribute . 
measurementTypeName, 
reason 

> 


To create a Measurement Job, best-effort is 
required. The parameter of 'unsupportedList' 
must be returned if status = PartialSuccess. 
The reason can be any of: 
measurementTypeName is unknown to the 

PMIRP. 

measurementTypeName is invalid. 

measurementTypeName is not supported in the 

specific implementation. 

The related IOC Instance is unknown (e.g. it 

does not exist at the time of this operation 

invocation) to the pmirp. 

Insufficient capacity to monitor the related IOC 

Instance(s). 

measurementTypeName is already monitored 
for the IOC instance with the same or another 
granularity period. 

When the input parameter iocinstanceList 
is empty, the unsupportedList shall be 
empty. 


status 


M 


ENUM (Success, Failure, 
PartialSuccess) 


An operation may fail because of a specified or 
unspecified reason. 



7.3.1.4 Pre-condition 

atLeastOneValidMeasurementType AND validStartTime AND validStopTime AND 
validSchedule AND validGranularityPeriod AND validReportingPeriod AND 
suf f icientCapacity AND validPriority. 





Definition 


atLeastOneValidMeasurementType 


At least one input measurementType is valid. The word valid means that the 
PMIRP is aware of this measurementType name, is aware of the 
ManagedEntity holding such measurementType and that the 
Measurement Job created can monitor its value according to the monitoring 
criteria, e.g. granularity period, given in the input parameter. 


validStartTime 


The startTime is valid. 


validStopTime 


The stopTime is valid. 


validSchedule 


The schedule is valid. 


validGranularityPeriod 


The granularityPeriod is valid. 


validReportingPeriod 


The reportingPeriod is valid. 


suf ficent Capacity 


The resource of EM and NE can support the requested measurement. 


validPriority 


The priority is valid. 



7.3.1.5 Post-condition 

someMeasurementTypeNamesMonitored AND 
notifyMeasurement Jobs tatusChangedMayBeEmit ted. 



Assertion Name 


Definition 


someMeasurementTypeNamesMonitored 


At least one input measurementTypeName is monitored 
by the newly created Measurement Job. 


notifyMeasurement JobStatusChangedMayBeEmit ted 


If Start time is "start now", the 

Measurement Job. jobStatus turns "Active" and a 
notifyMeasurementJobStatusChanged is emitted. 
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7.3.1.6 Exceptions 



Exception ^^^^H 




invalidStartTime 


Condition: validStartTime is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 
Exit state: Entry state. 


invalidStopTime 


Condition: vaiidStopTlme is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 
Exit state: Entry state. 


invalidSchedule 


Condition: validSchedule is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 
Exit state: Entry state. 


invalidGranularityPeriod 


Condition: validGranularityPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 
Exit state: Entry state. 


invalidReportingPeriod 


Condition: validReportingPeriod is false. 

Returned Information: Name of the exception; status is set to 'Failure'. 
Exit state: Entry state. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which is one 
of: emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList}, 
{neHDShortage neObjectlnstList}, {neLowMemory, neObjectlnstList}, maxJobReached, 
otherReason; status is set to 'Failure'. 
Exit state: Entry state. 


invalidPriority 


Condition: validPriority is false. 

Returned Information: Name of the exception; status is set to "Failure". 
Exit state: Entry state. 
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7.3.2 Operation stopMeasurementJob (M) 
7.3.2.1 Definition 

This operation supports IRPManager's request to stop a Measurement Job through Itf-N, after which, the 
Measurement Job may still be visible via Itf-N. Whether the Measurement Job is removed from the managed 
system is vendor specific and out of scope of the present document. 

The behaviour of the IRP Agent when the job is stopped is vendor specific, which means the job could be stopped at the 
end of the GranularityPeriod or immediately. 

After the job has been stopped, the notifyFileReady or notify FilePreparationError notification shall be emitted 
inmiediately or when the next reporting period is reached. 



7.3.2.2 Input parameters 









Comment 


Job Id 


M |Measurement Job . j obId 


It specifies the Measurement Job to be Stopped. 



7.3.2.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.2.4 Pre-condition 

measurement JobExists AND measurement JobCanBeStopped. 



Assertion Name 


Definition ^ 


measurement JobExists 


Measurement Job specified in the input parameter exists. 


measurement JobCanBeStopped 


Measurement Job specified in the input parameter can be stopped now. 



7.3.2.5 Post-condition 

measurement JoblsStopped AND notifyMeasurement JobStatusChangedEmitted. 



Assertion Name 


Definition 


measurement JobI sStopped . 


The Measurement Job Identified by jobid is stopped but may 
still be visible via Itf-N. The Job state is "Stopped". 


notifyMeasurement JobStatusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 



7.3.2.6 Exceptions 



Exception Name 




unknownJob 


Condition: (MeasurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


j obCannotBeStopped 


Condition: (measurementJobCanBeStopped) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.3.3 Operation suspendMeasurementJob (O) 
7.3.3.1 Definition 

This operation supports IRPManager's request to suspend a Measurement Job through Itf-N. When the 
Measurement Job is suspended, the collection of measurement result data by the Measurement Job will stop, 
regardless of its schedule, but the Measurement Job still exists. The suspend operation is necessary in following 
situation: 

- High work load experienced by managed system. 

- The specified measurement data is not needed in a specific duration. 

- Other specific requirement. 

After the job has been suspended, the notify FileReady or notifyFilePreparationError notification shall be emitted 
inmiediately or when the next reporting period is reached. 



7.3.3.2 Input parameters 



jobid 


M 


Measurement Job . j obid 


Comment 

It specifies the Measurement Job to be suspended. 



7.3.3.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.3.4 Pre-condition 

measurement JobExists AND measurement JoblsNotSuspended. 



Assertion Name 


Definition 


measurement JobExists 


The Measurement Job specified in the input parameter exists. 


measurement JobI sNotSuspended 


The Measurement Job specified in the input parameter is not suspended. 
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7.3.3.5 Post-condition 



measurement JoblsSuspended AND notifyThresholdMonitorStatusChangedEmitted AND 
not ifyMeasurement Jobs tatusChangedEmit ted. 



Assertion Name ^^^^^^^H 


Definition 


Measurement JobI sSuspended 


The Measurement Job identified by measurementJobld is 
suspended. It means the following. 

(a) All files open for capturing measurement results are 
closed. 

(b) If one of the files closed contain measurement data, a 
notifyFileReady is emitted indicating the availability of the 
file(s). 

(c) No more reading of measurementType values. 

(d) The Measurement Job . j obStatus is set tO 
'Suspended'. 

(e) For an IRPAgent using the measurement result data for 
threshold monitoring, the detection of the related 
performance alarm conditions is suspended. 


notifyThresholdMonitorStatusChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted, if the 
ThresholdMonitor behaviour is dependent on the availability of 
the measurement result. 


notifyMeasurement JobStatusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 



7.3.3.6 Exceptions 



Exception Name 


Definition 


unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


j obAlreadySuspended 


Condition: (measurementJoblsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.3.4 Operation resumeMeasurementJob (O) 
7.3.4.1 Definition 

This operation supports IRPManager's request to resume a suspended Measurement Job. When the 
Measurement Job is resumed, it will work according to criteria (e.g. granularity period, startTime, stopTime, 
schedule) set up by the corresponding createMeasurement Job operation. 



7.3.4.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


jobid 


M 


Measurement Job . j obid 


It specifies tine Measurement Job to be resumed. 



7.3.4.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUIVI (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.3.4.4 Pre-condition 

measurement JobExists AND measurement JoblsSuspended AND suf f icientCapacity. 



Assertion Name 




measurement JobExists 


Measurement Job specified by the input parameter exists. 


measurement JobI sSuspended 


Measurement Job specified by the input parameter is suspended. 


suf f icientCapacity 


The resource of EM and NE can support the requested 
measurement . 



7.3.4.5 Post-condition 

measurement JoblsResumed AND notif yMeasurement JobStatusChangedEmitted. 





Definition 


measurement JoblsResumed 


The Measurement Job identified by MeasurementJobId is 
resumed., It means the following. This resumed 

Measurement Job shall behave as it did when it was first 
created by createMeasurement Job. 
Depending on the current time and the 
JobMeasurementSchedule . startTime, the 
Measurement Job. jobStatus will be set accordingly. 


not if yMeasurement JobStatusChangedEmitted 


The notifyMeasurementJobStatusChanged is emitted. 
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7.3.4.6 Exceptions 







unknownJob 


Condition: (measurementJobExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


j oblsNotSuspended 


Condition: (measurementJoblsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


highWorkLoad 


Condition: sufficientCapacity is false. 

Returned Information: Name of the exception and the detailed reason which is one of: 
emCpuBusy; emHDShortage, emLowMemory, {neCpuBusy, neObjectlnstList}, {neHDShortage 
neObjectlnstList}, {neLowMemory, neObjectlnstList}, maxJobReached, otherReason; status is 
set to 'Failure'. 
Exit state: Entry state. 
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7.3.5 Operation listMeasurementJobs (M) 
7.3.5.1 Definition 

This operation supports IRPManager's request to list the information of all or a set of specified current 
Measurement Jobs. 



7.3.5.2 Input parameters 



Parameter 


Qualifier 


Information type 


^^^^^^^^^^^^^__Comment 


j obldList 


M 


List of 

<]y[easurement Job . j obId> 


This parameter specifies the criteria to list the Measurement Jobs. 
If the parameter specifies the list of jobid to be retrieved, then the 
corresponding information of jobs will be returned. 
If the parameter contains no information, all the 
Measurement Jobs are retrieved. 



7.3.5.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 




j obinf oList 


M 


List of< 
attributes of 

Measurement Job, 
attributes of 

JobMeasurement Schedule, 
(refer to definition and legal 
values in clause 6.5.1) 
iOCName, 
iOCInstanceList, 
measurementCategoryList 
(refer to input parameter of 
createMeasurementJob in 
clause 7.3.1.2) 
> 


Returned information of corresponding Measurement Jobs 
matching the input criteria. If no match, then the length of the 
joblnfolist will be (with status == Success). 

Jobs are created by successful invocation of 
createMeasurementJob (see 7.3.1.2). 

If the job is created using non-empty iocinstanceList in 
createMeasurementJob, then iOCInstanceList here shall 
contain the DNs of the supported IOC instances. 

If the job is created using empty iocinstanceList, then 
iocinstanceList here shall be empty as well. This case is 
valid only if IRPAgent support the use of empty list, (see clause 
7.3.1.2) 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.3.5.4 Pre-condition 

j obldList I sVal id. 







j obldList I sVal id 


j ObldList specified in the input parameter is valid. 



7.3.5.5 Post-condition 

measurement JobsAreReturned AND measurement JobNotAffected. 



Assertion Name 


Definition 


measurement JobsAreReturned 


The information of required Measurement Jobs are returned in the output 
parameters. 


measurement JobNotAffected 


The current Measurement Job (s) are not affected by the operation. 
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7.3.5.6 Exceptions 



Exception Nam^^H 


Definition 


invalidJobldList 


Condition: (jobidListisValid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 



7.4 PMIRPOperations_2 Interface (O) 
7.4.1 Operation createThresholdMonitor (M) 
7.4.1 .1 Definition 

This operation supports IRPManager's request to create a ThresholdMonitor that defines the thresholds for some 
specific measurementTypes. If the threshold defined is (a) crossed or (b) reached, the related performance alarms will 
be emitted to subscribed IRPManager ( s ) . 

Two cases are allowed: 

- One case only accepts threshold monitoring of measurementType(s) that are already under monitoring by an 
existing Measurement Job. This kind of PMIRP will not monitor a measurementType for (a) threshold- 
crossing or (b) threshold reaching or for clearing if that measurementType is not already subject to a 
Measurement Job monitoring. This kind of PMIRP will only determine the (a) threshold crossing or (b) 
threshold reaching and clearing events when the related Measurement Job ( s ) are in Active states. The 
IRPManager, when interacting with this kind of PMIRP, must first start a Measurement Job to monitor the 
measurementTypes and then invoke this operation for the same measurementTypes. 

The other case is that it can accept threshold monitoring of measurementType(s) regardless if they are already 
under monitoring by existing Measurement Job ( s ) . ThresholdMonitor is independent of any existing 
Measurement Job(s) and no new Measurement Job(s) are created for threshold monitoring purposes. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
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7.4.1 .2 Input parameters 





Qualifier 


Information t^^^^^^^^^H 


^1 Comm^^^^^l 


iOCName 


M 


ManagedEntity . ob j ectClass 


It specifies the 
ManagedEntity class 
name of the instances 
specified by 
iOCInstanceList. 


iOCInstanceList 


M 


List of <ManagedEntity . obj ectlnstance> 


It specifies the DNs of 
IVIanagedEntity instances 
whose 

measurementTypes are 
to be monitored. 
At least, one instance 
shall be specified. 


thresholdinf oList 


M 


List of 
< 

MeasuredAttribute . measurementTypeName, 

Monitor . probableCause, 

Monitor . specif icProblem, 

Monitor . direction, 

thresholdPack 

> 

where thresholdPack is list of 

thresholdPackElement. 

The thresholdPackElement is STRUCT 

< 

ThresholdLevel . thresholdValue, 
ThresholdLevel . thresholdSeverity, 
ThresholdLevel . hysteresis, 

> 


It specifies the thresholds 
to specific 

measurementTypes. 
See clause 6.5.1 
(definition and legal 
values). 
The number of 
ThresholdLevel in 
thresholdLevelList 
must oe 1 , ^, o or 4. 


monitorGranularityPeriod 


M 


Monitor . monitorGranularityPeriod 


See clause 6.5.1 
(definition and legal 
values). 



7.4.1.3 Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment ^^^^M 


monitorld 


M 


ThresholdMonitor . monitorld. 


It specifies the unique identifier of the 
ThresholdMonitor in the PMIRP Agent. 


unsupportedList 


M 


List of < 

ManagedEntity . obj ectClass, 

ManagedEntity . obj ectlnstance, 

MeasuredAttribute . 

measurementTypeName, 

reason 

> 


To create a ThresholdMonitor, best-effort is 
required. This parameter identifies the 
unsupported but requested measurementType(s). 
The reason can be: 

(a) The pmirp has trouble starting monitoring the 
threshold of this measurementType. 

(b) The measurementType is illegal. 

(c) The measurementType exists but it is not 
currently under monitoring by any 
Measurement Job and that the PMIRP 
requires that it be under monitoring by 
Measurement Job (before it can be monitored 
for thresholding). 

(d) Hysteresis is overlapped. 

This parameter is used only when the operation 
returns 'PartialSuccess'. 


status 


M 


ENUM (Success, Failure, 
PartialSuccess) 


An operation may fail because of a specified or 
unspecified reason. 
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7.4.1 .4 Pre-condition 



validGranularityPeriod AND someValidMeasurementType AND validDirection AND 
validNumberOf ThresholdPackElements AND validOrderOf ThresholdPackElements. 



Assertion Name ^^^^^| 


Def i n it io^^^^^^^^^^^^^^^^^^^ 


validGranularityPeriod 


The monitorGranularityPeriod is valid. 


someVal idMeasurementType 


At least one requested measurementType can be monitored for 
thresholding. 


validDirection 


The direction is valid. 


validNumberOf ThresholdPackElements 


If PMiRP supports multi-level thresholdSeverity, it is valid if the number of 
elements in thresholdPack is 1 , 2, 3 or 4. 

If PMIRP does not support multi-level thresholdSeverity, it is valid if the 
number is 1. 


validOrderOf ThresholdPackElements 


This assertion is applicable if pmirp supports multi-level 
thresholdSeverity. It is valid if it satisfies the constraint defined by 
multiLevelSeverityOrder of clause 6.5.2 (constrains). 



7.4.1.5 Post-condition 

thresholdMonitorlsCreated AND notif yObj ectCreationEmitted. 



Assertion Name 


Definition 


thresholdMonitorlsCreated 


The ThresholdMonitor identified by monitorld exists. And the performance alarm 
shall be emitted if the thresholds are (a) crossed or (b) reached and the 
thresholdMonitorStatus is "Active". (See 6.3.8.1 for clarification of the alternatives 

(a) and (b)) 

The ThresholdMonitor.thresholdMonitorStatus will be Active. 


notif yObj ectCreationEmitted . 


The notifyObjectCreation is emitted to indicate the creation of a 
ThresholdMonitor. 



7.4.1 .6 Exceptions 



Exception Name 


Definition 


invalidClassOr Instances 


Condition: (validClassAndlnstances) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


invalidGranularityPeriod 


Condition: (validGranularityPeriod) not verified. 

Returned Information: Name of the exception; status is set to 

'Failure'. 

Exit state: Entry state. 


noVal idMeasurementType 


Condition: (someValidMeasurementType) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidNumberOf ThresholdPackElements 


Condition: 4(validNumberOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidOrderOf ThresholdPackElements 


Condition: (validOrderOfThresholdPackElements) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 


invalidDirection 


Condition: (validDirection) not verified. 

Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.4.2 Operation deleteThresholdMonitor (M) 
7.4.2.1 Definition 

This operation supports IRPManager's request to delete a specified ThresholdMonitor. 

At the time of the removal, all outstanding (a) threshold-crossing or (b) threshold reaching alarms will stay (i.e. the 
FMIRP Agent's AlarmList will contain an Alarminf ormation indicating (a) threshold-crossing or (b) threshold 
reaching). The IRPManager needs to use other means to remove the Alarminf ormation in the FMIRP 
AlarmList. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 



7.4.2.2 Input parameters 



Parameter 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThresholdMonitor . monitorld 


It specifies the ThresholdMonitor to be Stopped and 
removed. 



7.4.2.3 Output parameters 



Parameter 
NanUM 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, 
Failure) 


An operation may fail because of a specified or unspecified 
reason. 



7.4.2.4 Pre-condition 

thresholdMonitorExists. 



, Assertion Name 


Definition 


thresholdMonitorExists 


ThresholdMonitor specified in the input parameters exists. 



7.4.2.5 Post-condition 

thresholdMonitorlsDeleted AND notif yOb j ectDeletionEmitted.. 





Definition ^^^^^^^^^^^^^^^^^^^ 


thresholdMonitorlsDeleted 


ThresholdMonitor identified by monitorld ceases to exist. 


notif yObj ectDeletionEmitted 


The notifyObjectDeletion is emitted to indicate the deletion of a ThresholdMonitor. 



7.4.2.6 Exceptions 



Exception Name 


Definition 


unknownThresholdMonitor 


Condition: (thresholdlVlonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 
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7.4.3 Operation listThresholdMonitors (M) 



7.4.3.1 Definition 



This operation supports IRPManager's request to list detailed information about all or specified 
ThresholdMonitors. 



7.4.3.2 



Input parameters 




monitorldList 



List of 

<ThresholdMonitor . monitorId> 



This parameter specifies the ThresholdMonitors 
to be listed. 

If the parameter specifies the list of monitorlds, then 
the corresponding information of 
ThresholdMonitors will be returned. 



If the parameter contains no information, all the 
ThresholdMonitors in the PMiRP Agent will be 
returned. 



7.4.3.3 Output parameters 



Parameter Name 


Qualifier 


IVIatchH^HI^^^B 




monitorinf oList 


M 


List of < 
attributes of 

ThresholdMonitor (see 

definition and legal values in 

clause 6.5.1), 

iOCName, 

iOCInstanceList, 

thresholdlnfoList (See clause 

7.4.1 .2 input parameters of 

create thresholdMonitor 

operation) 

> 


Returned information of corresponding 
ThresholdMonitors matching the input criteria. If no 
match, then the length of the monitorlnfolist will be (with 
status == Success). 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or 
unspecified reason. 



7.4.3.4 Pre-condition 

monitorldList I sValid. 



Assertion Name 


Definition 


monitorldListlsValid 


monitorldList specified in the input parameter is valid. 



7.4.3.5 Post-condition 

thresholdMonitorsAreReturned AND thresholdsAreUnaf f ected. 



thresholdMonitorsAre 
Returned 


The information of required ThresholdMonitors are returned in the output 
parameters. 


thresholdsAreUnaf f ected 


The ThresholdMonitors are not affected. 
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7.4.3.6 Exceptions 



Exception Name 


Def i n it io^^^^^^^^^^^^^^^^^^^l 


invalidMonitorldList 


Condition: (monitorldListlsValid) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 
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7.5 PMIRPOperations_3 Interface (O) 
7.5.1 Operation suspendThresholdMonitor (M) 
7.5.1.1 Definition 

This operation supports IRPManager's request to suspend the ThresholdMonitor . If the operation succeed, its 
thresholdMonitorStatus shall be set to "Suspended". PMIRP shall not emit performance alarms related to this 
ThresholdMonitor. The ThresholdMonitor shall still exist. 



7.5.1 .2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


monitorld 


M 


ThresholdMonitor . monitorld 


It specifies tine ThresholdMonitor to be suspended. 



7.5.1.3 Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or unspecified reason. 



7.5.1.4 Pre-condition 

thresholdMonitorExists AND thresholdMonitorlsNotSuspended. 



Assertion Name 


Definition ^^^^^^^H 


thresholdMonitorExists 


ThresholdMonitor specified in the input parameter exists. 


thresholdMonitorlsNotSuspended 


ThresholdMonitor specified in the input parameter is not suspended. 



7.5.1.5 Post-condition 

thresholdMoni tor Is Suspended AND notif yThresholdMonitorStatusChangedEmitted. 



Assertion Name ^^^^^^^H 


Definition ^^^^^^ 


thresholdMoni tor I sSuspended 


The ThresholdMonitor identified by monitorld is 
suspended, that means it will not work until it is resumed. 
The ThresholdMonitor . thresholdMonitorStatus will 
be 'Suspended'. 


notif yThresholdMonitorStatusChangedEmit ted 


The notifyThresholdMonitorStatusChanged is emitted. 



7.5.1.6 Exceptions 



Exception Name 


Definition 


unknownThresholdMonitor 


Condition: (thresholdMonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMoni torAlreadySuspended 


Condition: (thresholdMonitorlsNotSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.5.2.1 Definition 

This operation supports IRPManager's request to resume a suspended ThresholdMonitor . 

7.5.2.2 Input parameters 



^Parameter Name 


Qualifier 


Information type 




monitorld 


M 


ThresholdMonitor . monitorld 


It specifies the ThresholdMonitor to be resumed. 



7.5.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment ,„|„,„| 


status 


M 


ENUM (Success, Failure) 


An operation may fail because of a specified or 
unspecified reason. 



7.5.2.4 Pre-condition 

thresholdMonitorExists AND thresholdMonitorlsSuspended. 



Assertion Name 


Definition 


thresholdMonitorExists 


ThresholdMonitor specified in the input parameter exists. 


thresholdMonitorlsSuspended 


ThresholdMonitor specified in the input parameter is suspended. 



7.5.2.5 Post-condition 

thresholdMonitorlsResumed AND notif yThresholdMonitorStatusChangedEmitted. 



thresholdMonitorlsResumed . 


The ThresholdMonitor identified by monitorld is resumed, 
that means it will work again. The 

ThresholdMonitor . thresholdMonitorStatus will be 
"Active". 


notifyThresholdMonitorStatusChangedEmitted 


The notifyThresholdMonitorStatusChanged is emitted. 


7.5.2.6 Exceptions 



Exnpption Name , 


II Definition | 


unknownThresholdMonitor 


Condition: (thresholdMonitorExists) not verified. 

Returned information: output parameter status is set to 'Failure'. 

Exit state: Entry State. 


thresholdMonitorlsNotSuspended 


Condition: (thresholdMonitorlsSuspended) not verified. 
Returned information: output parameter status is set to 'Failure'. 
Exit state: Entry State. 
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7.6 PMIRPNotification_1 Interface (M) 

7.6.1 notif yMeasurement JobStatusChanged (M) 
7.6.1.1 Definition 

The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a Measurement Job. The 
status changes in that case include Suspended=>Scheduled, Active=>Suspended, Scheduled=>Suspended, 
Suspended=>Active, Scheduled=>Active, Active=>Stopped, Suspended=>Stopped, Scheduled=>Stopped. 



7.6.1 .2 Input parameters 



^^jl^^Q^t^l^gme 


Qualifier 






obj ectClass 


M, Y 


PMIRP. objectClass 


Notification header - see [12]. It shall carry the 
PMIRP class name. 


obj ectlnstance 


M, Y 


PMIRP. objectlnstance 


Notification header - see [1 2]. It shall carry the 
DN of the PMIRP. 


eventTime 


M, Y 




Notification header - see [12]. 


not i f i cat i onType 


M, Y 


"notifyMeasurementJobStatusChanged" 


Notification header - see [12]. 


systemDN 


C, Y 




Notification header - see [12]. 


notif icationid 


M, N 




Notification header - see [12]. 


jobid 


M, Y 


Measurement Job . j obid 




j obStatus 


M, N 


Measurement Job . j obStatus 


The new status of the Measurement Job . 


reason 


0, N 




It carries one or several of the assertion names 
of the From-state of Triggering Event. 



7.6.1.3 Triggering Event 
7.6.1.3.1 From-state 

f ailToReadMeasurementTypesForExtendedProlongPeriod OR internalProblem OR 
stopMeasurement Job OR stopTimeReached OR resumeMeasurement Job OR 
suspendMeasurement Job OR startTimeReached OR suspendMeasurement JobBySystem 



Assertion Name 


Definition 


f ailToReadMeasurementTypesForExtendedProlongPeriod 


Because the pmirp Agent have failed to read the 
monitored measurementType (s) from managed 
resources for one or more times, the pmirp Agent 
decides that it will not try to read in the future and 
place the Measurement Job in "Stopped" State. 


internalProblem 


Because of an unspecified internal problem, pmirp 
Agent decides that it no longer can maintain the 
Measurement Job in any jobStatus but "Stopped". 


StopMeasurement Job 


The StopMeasurement Job returns success. 


StopTimeReached 


The stop time for Measurement Job has been 
reached. 


resumeMeasurement Job 


The resumeMeasurement Job returns success. 


suspendMeasurement Job 


The suspendMeasurement Job returns success. 


StartTimeReached 


The start time for Measurement Job has been 
reached. 


suspendMeasurement JobBySystem 


The MeasurementJob has been suspended by the 
system in case of overload 
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7.6.1.3.2 To-state 

measurement Jobs tatusChanged 



l^^^^l Assertion Name 


^^^^^1 Definition 


measurement Jobs tatusChanged 


The Measurement Job . j obstatus changed to a new value. 



7.6.2 Void 
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7.7 PMIRPNotification_2 Interface (O) 
7.7.1 notifyThresholdMonitorObjectCreation (M) 
7.7.1.1 Definition 

IRP Agent notifies the subscribed IRPManager that a new Monitor instance has been created and that the notification 
satisfies the filter constraint expressed in IRPManager" s subscribe operation (see TS 32.302 [12]). 



7.7.1 .2 Input Parameters 











obj ectClass 


M, Y 


PMIRP.objectClass 


See Table 7.6.1.2. 


obj ectlnstance 


M, Y 


PMIRP.objectlnstance 


See Table 7.6.1.2. 


notif icationid 


M. N 




See Table 7.6.1.2. 


eventTime 


M, Y 


ManagedEntity.creationTime 


See Table 7.6.1.2. 


systemDN 


C,Y 




See Table 7.6.1.2. 


not i f i cat i onType 


M, Y 


'notifyThresholdMonitorObjectCreation' 


Notification header - see [12]. 


monitorld 


M, N 


Monitor.monitored 


See monitorld definition in clause 
6.5.1. 


monitorGranularityPeriod 


M, N 


Monitor.monitorGranularityPeriod 


See monitorGranularityPeriod 
definition in clause 6.5.1. 


thresholdMonitorStatus 


M, N 


ThresholdMonitor.thresholdMonitorStatus 


See thresholdMonitorStatus 
definition in clause 6.5.1 . 



7.7.1.3 Triggering Event 
7.7.1.3.1 From-state 

stateBef oreOb j ectCreation. 





Definition 


stateBef oreObj ectCreation 


The number of instances of the IOC Managed Entity is equal to N. 


7.7.1.3.2 To-State 




stateAf terOb j ectCreation. 






Definition 


stateAf terObj ectCreation 


The number of instances of the IOC ManagedEntity is equal to N + 1 . 
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7.7.2 notifyThresholdMonitorObjectDeletion (M) 
7.7.2.1 Definition 

IRP Agent notifies the subscribed IRPManager of a deleted Monitor instance. The IRP Agent invokes this notification 
because the subject notification satisfies the filter constraint expressed in the IRPManager subscribe operation (see 
TS 32.302 [12]). 



7.7.2.2 Input Parameters 



obj ectClass 


M, Y 


PMIRP.objectClass 


See Table 7.6.1.2. 


obj ectlnstance 


M, Y 


PMIRP.objectlnstance 


See Table 7.6.1.2. 


notif icationid 


M, N 




See Table 7.6.1.2. 


eventTime 


M, Y 


ManagedEntity.deletionTime 


See Table 7.6.1.2. 


systemDN 


C,Y 




See Table 7.6.1.2. 


not i f i cat i onType 


M, Y 


'notifyThresholdMonitorObjectDeletion' 


Notification header - see [12]. 


monitorld 


M, Y 


Men iter, monitored 


See monitorld definition in clause 6.5.1. 



7.7.2.3 Triggering Event 
7.7.2.3.1 From-state 

stateBef oreOb j ectDeletion. 







stateBef oreObj ectDeletion 


The number of instances of the IOC ManagedEntity is equal to N. 


7.7.2.3.2 To-state 




stateAf terOb j ectDeletion. 








stateAf terObj ectDeletion 


The number of instances of the IOC ManagedEntity is equal to N - 1 . 
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7.7.3 notifyThresholdMonitorStatusChanged (O) 
7.7.3.1 Definition 

The PMIRP Agent notifies all subscribed IRPManagers about the status changes of a ThresholdMonitor. 
The status changes in that case include Suspended=> Active, Active=>Suspended. 

NOTE: The notifyThresholdMonitorStatusChanged notification is mandatory if PMIRPOperations_2 is 
supported. 



7.7.3.2 Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


obj ectClass 


M, Y 


PMIRP. objectClass 


See Table 7.6.1.2. 


obj ectlnstance 


M, Y 


PMIRP. objectlnstance 


See Table 7.6.1.2. 


eventTime 


M, Y 




See Table 7.6.1.2. 


not i f i cat ionType 


M, Y 


"notifyThresholdMonitorStatusChanged". 


See Table 7.6.1.2. 


systemDN 


C, Y 




See Table 7.6.1.2. 


notif icationid 


M, N 




See Table 7.6.1.2. 


monitorld 


M, Y 


Monitor . monitorld 




monitorStatus 


M, N 


ThresholdMonitor . thresholdMonitorStatus 


The new status of the 

ThresholdMonitor . 


reason 


0, N 




It carries one or several of the 
assertion names of the From-state 
of Triggering Event. 



7.7.3.3 Triggering Event 
7.7.3.3.1 From-state 

resumeThresholdMonitor OR suspendThresholdMonitor 





^ ^ ^ „ Definition 


resumeThresholdMonitor 


The resumeThresholdMonitor returns success. 


suspendThresholdMonitor 


The suspendThresholdMonitor returns success. 



7.7.3.3.2 To-state 

thresholdMonitorStatusChanged 







thresholdMonitorStatusChanged 


The ThresholdMonitor . thresholdMonitorStatus changed tO a new value. 
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8 Scenarios 



8.1 createMeasurementJob 



:NM 



: IRPAgent 



createMeasurementJob 



return success 



If schedule is reached, PMIRP Agent begins to collect the dataL 
according to the input parameters, and emit the 
notifyFileReady notification at the end of each reporting 
period. Now thejobStatus is "Active". 



notifyFileReady 



IRPManager maygetK 
file(s)byFile 
Transfer IRP. 



listMeasurementJobs( ) 



return required info 



IRPManager can request PMIRP 
Agent to list all the jobs for the 
specified filter. 
listFilesO 



return reqliired info 



IRPManager can request PMIRP K 
Agent to list all the files for a 
specified job and filter. 



Figure 8.1: Scenariol of Performance Management 
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8.2 stopMeasurementJob 



:NM 



: IRPAqent 



IR PManager can request PMIR P Agent 
to stop a specified job in any situation, 
no matter the jobStatus is "Scheduled", 
"Active" or "Suspended". 



stoplVleasuVennentJob () 



return success 

< 



T 



Figure 8.2: Scenario2 of Performance Management 
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8.3 stopMeasurementJob/listMeasurementJobs/listFiles 



:NM 



: IRPAqent 



IRPManager can request PMIRP Agent 
to stop a specified job in any situation, 
no matter the jobStatus is "Scheduled", 
"Active" or "Suspended". 



stoplVleasurementJob () 



return success 



listlVleasurementJobsO 



return required info 



If the measurementJob is not 
removed, the information of stopped 
measurementJob can be returned 



listFilesQ 



return required info 



If the files of a stopped 
measurementJob are still existing in 
the PMIRP Agent, their inform ation can 
be returned to IRPManager if required. 



Figure 8.3: Scenarios of Performance Management 
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8.4 suspendMeasurementJob/resumeMeasurementJob 



:NM 



: IRPAqent 



IRPManager can request PMIRP Agent to 
suspend a "Scheduled" or "Active" job in 
some situation, such as high work load. 



\ 

suspendMeasurementJobQ 
return success 



If the "suspend" operation is i 
successful, the jobStatus is changed 
to "Suspended" accordingly. 



IRPManager can request I 
PMIRP Agent to resume 
a "Suspended" job. 



resumeMea^urementJobO 



return success 



If the "resume" operation is I 
successful, the jobStatus 
is changed to "Scheduled" 
or "Active" according to the 
iob schedule. 



Figure 8.4: Scenario4 of Performance Management 
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Annex A (normative): 

Illustration of the state described in the state Diagram 

A.1 Definition of state 
A.1.1 Scheduled 

"Scheduled" means that the job has been created and the start time has not been reached. 

A. 1.2 Suspended 

"Suspended" means that the job has been suspended for some reason. 

A. 1.3 Active 

"Active" means that the start time of a Measurement Job has been reached. 
There are two sub-states: "Busy" and "Idle". 

"Busy" means that the Measurement Job is monitoring the measurementTypes. 
"Idle" means that the Measurement Job is not monitoring the measurementTypes. 

When a Measurement Job becomes active, it does not mean that the job is immediately busy. IRPManager can set 
the detailed time frame (e.g. dailySchedule or weeklySchedule) for a Measurement Job to be busy. If there is no time 
frame schedule for a job, it immediately monitors the measurement types when it becomes active. 

A. 1.4 Stopped 

"Stopped" means that the Measurement Job is deleted via the Itf-N. Whether the managed system removes the 
Measurement Job immediately or later is vendor specific. 
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A.2 State transition scenarios 

The following scenarios give examples of state transitions. 



A.2.1 Scenario 1 

A Measurement Job is created at 11:00, and the startTime is 14:00, stopTime is 18:00. At 12:00, the 
Measurement Job is suspended, and at 13:00, the Measurement Job is resumed. 



job is Scheduled 



job is Suspended 



job is Scheduled 



job is Active 



11:00 



12:00 



13:00 



14:00 



Time 



create 

measurement job 



suspend 

measurement job 



resume 

measurement job 



start 

time reached 



At 1 1 :00: the Measurement Job becomes scheduled after it was created. 

At 12:00: the Measurement Job is suspended and the jobStatus is "Suspended". 

At 13:00: the Measurement Job is resumed, and the jobStatus is "Scheduled" because the start time has not been 
reached. 

At 14:00: the Measurement Job becomes active because start time has been reached. 



Figure A.2.1 : Scenario 1 



A.2.2 Scenario 2 

A Measurement Job is created at 11:00, and the startTime is 12:00, stopTime is 18:00. At 13:00, the 
Measurement Job is suspended, and at 14:00, the Measurement Job is resumed. 



' job is Scheduled ' 
\< ^ 



job is Active 



job is Suspended 



job is Active 
► 



11:00 



12:00 



13:00 



14:00 



Time 



create 

measurement job 



start 

time reached 



suspend 

measurement job 



resume 

measurement job 



At 1 1 :00 
At 12:00 
At 13:00 
At 14:00 



the Measurement Job becomes scheduled after it was created, 
the start time is reached, and the jobStatus is "Active", 
the Measurement Job is suspended, and the jobStatus is "Suspended" 
the Measurement Job is resumed, and the jobStatus is "Active". 



Figure A.2.2: Scenario 2 
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A.2.3 Scenario 3 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is never stop. There is no other 
schedule defined. IRPManager stops the job at 14:00. 



' job is Scheduled ' 
\< ^ 



job is Active 



-►i 



11:00 



12:00 



13:00 



14:00 



Time 



create 

measurement job 



start 

time reached 



stop 

measurement job 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is Stopped when IRPManager stops the job. 



Figure A.2.3: Scenario 3 



A.2.4 Scenario 4 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 14:00. There is no other schedule 
defined. 



I I 
' job is Scheduled ' 
\< ^ 



job is Active 



-►i 



11:00 



12:00 



13:00 



14:00 



Time 



create 

measurement job 



start 

time reached 



stop time reached 



At 1 2:00: the Measurement Job becomes active when start time is reached. Since there is no schedule for the job, 

it starts monitoring measurement types immediately. 
At 14:00: the Measurement Job is Stopped automatically when stop time is reached. 



Figure A.2.4: Scenario 4 
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A.2.5 Scenario 5 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is "never stop". There is a 
dailySchedule defined, which is 13:00-14:00 and 15:00-16:00 every day. 



job is Active 



job is 

! Scheduled 



job is Idle 



job is Busy 



I 



->k- 



I job is Idle I 



job is Busy 



_^ job is Idle 



11:00 



12:00 



13:00 



14:00 



15:00 



16:00 



Time 



create 
measurement job 



start 

time reached 



dailySchedult 



dailySchedule 



At 12:00: the Measurement Job becomes active when start time has been reached. Since there is a schedule for 
the job, the job monitors measurement types only during the specified schedule. During other times, the 
job is idle. 

At 13:00 and 15:00: the Measurement Job becomes busy when the daily schedule has been reached. 



Figure A.2.5: Scenario 5 
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A.2.6 Scenario 6 

A Measurement Job is created at 11:00 and the startTime is 12:00, stopTime is 13:30. The 

Measurement Job . granularityPeriod is 30 minutes and the Measurement Job . reportingPeriod is 1 
hour. There is no other schedule defined. 



job is Scheduled 



4*- 



job is Active and Busy 



11:00 



12:00 



create 

measurement job 



start 

time reached 



13:00 



13:30 



14:00 



Time 



. t . — 



stop 

time reached 



file is available and a 
notifyFileReady 
notification is sent 



file is available 
and a 

notifyFileReady 
notification is sent 



At 12:00: the Measurement Job becomes active when start time is reached. Since there is no detailed time frame 

for the job, the job begins to work at the same time. 
At 13:00: the file(s) of the Measurement Job are available, and pmirp emits the notifyFileReady notification to 

subscripted IRPManager. 
At 13:30: the Measurement Job is automatically Stopped when stop time is reached. 
At 14:00: pmirp will emit the last notifyFileReady notification. 



Figure A.2.6: Scenario 6 
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Annex B (normative): 

Threshold related performance alarms Triggering Events 

This annex defines the Triggering Events for the various performance alarms. The Triggering Events normally are 
defined by each notification type, such as notif yChangedAlarm, under the clause "Triggering Events". The 
Triggering Events related to thresholding are defined here collectively for ease of reference. 

The Triggering Events are defined in a state transition table. The column labels (e.g. 0, 1, 2, 3 of table in clause B.l) 
denote the to-state while the row labels denote the from-state. The cell denotes the emission action. 

There are two clauses. Clause B.l defines the Triggering Events for IRPAgent that supports 

notif yChangedAlarm. Clause B.2 defines those for IRPAgent that does not support notif yChangedAlarm. 
Clause B.3 provides samples of triggering events. 
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B.1 IRPAgent supporting notifyChangedAlarm 



Table B.1 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 


1 notifyChangedAlarm 


From 
State-4 


1 notifyClearedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


1 notifyChangedAlarm 


no emission 



The horizontal '0', T, '2', '3' and '4' are the to-states indicating the current measurementXype value with respect to the 
different threshold levels. Threshold levels are associated with severity level (thresholdSeverity). Higher threshold level 
associates with higher severity level (thresholdSeverity). 

EXAMPLE: If direction = 'Increasing', state-0 means the measurementXype value is below all thresholds. 

State-2 means that the measurementXype value is above threshold level 2 but below threshold 
level 3. If direction = 'Decreasing', state-0 means the measurementXype value is above all 
thresholds. State-2 means that the measurementXype value is below threshold level 2 but above 
threshold level 3. 

Xhe vertical '0', T, '2", '3' and '4' are the from-states indicating the last-read measurementXype value with respect to the 
threshold levels. 

A threshold has a value and may have a hysteresis. A threshold with hysteresis has a threshold-high value and a 
threshold-low value that are different from the threshold value. A threshold without hysteresis can be considered as a 
threshold whose threshold-high and threshold-low values are equal to the threshold value. 

For the direction = 'Increasing', the shaded cells indicate transitions caused by measurementXype values (a) rising 
across or (b) reach one or more threshold-high values. Xhe non-shaded cells indicate transition caused by 
measurementXype values falling across one or more threshold-low values. 

For the direction = 'Decreasing', the shaded cells indicate transitions caused by measurementXype values (a) falling 
across or (b) reach one or more threshold-low values. Xhe non- shaded cells indicate transition caused by 
measurementXype values rising across one or more threshold-high values. 

Each cell indicates the performance alarm emission when from-state transits to to-state. Xhe notifyNewAlarm and 
notifyChangedAlarm shall carry the severity level (perceivedSe verity) associated with the to-state 
(thresholdSeverity) . 

Xhe ThresholdMonitor determines, at monitorGP=X, if a threshold has been (a) crossed or (b) reached by 
comparing the value read at monitorGP==X with the value read at monitorGP==X-l. In initial condition (i.e. when the 
XhresholdMonitor reads the value at monitorGP=l), the (hypothetical) value read at monitorGP==X-l is assumed to be 
at state-0. 

(See 6.3.8.1 for clarification of the alternatives (a) and (b)) 
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B.2 IRPAgent not supporting notifyChangedAlarm 



Table B.2 





To State-0 


To State-1 


To State-2 


To State-3 


To State-4 


From 
State-0 


no emission 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


1 notifyNewAlarm 


From 
State-1 


1 notifyClearedAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-2 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


From 
State-3 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 


1 notifyClearedAlarm 
1 notifyNewAlarm 


To State-4 


1 notifyClearedAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


1 notifyClearedAlarm 
1 notifyNewAlarm 


no emission 



The Monitor determines, at monitorGP=X, if a threshold has been crossed by comparing the value read at monitorGP 
==X with the value read at monitorGP ==X-1. In initial condition (i.e. when the Monitor reads the value at monitorGP 
=1), the (hypothetical) value read at monitorGP ==X-1 is assumed to be at state-0. 
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B.3 Examples 
B.3.1 Example 1 

Figure B.3.1 illustrates multi-level thresholdSe verity thresholding behaviour. The horizontal axis indicates the time 
intervals specified by the Monitor . monitorGranularityPeriod (monitorGP). The vertical axis indicates the 
monitored measurementType values. The measurementType of this example is of type gauge. The 
Monitor . direction is set to "Increasing". 

Further suppose that the measurementType is monitored for a (a) two-level-severity-threshold-crossings or (b) two- 
level-severity-threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the lower-level-severity is set to 3 with a hysteresis low and high levels set to 2 and 4 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Minor. 

The threshold for the higher-level-severity is set to 7 with a hysteresis low and high levels set to 6 and 8 respectively 
(i.e. hysteresis value =1). The thresholdSeverity level is Major. 

The performance alarm triggering events are: 

1 . At monitorGP interval 3, trigger a not i f yNewAlarm with perceivedSe verity (ps) = Minor. 

2. At monitorGP interval 5, if the IRPAgent supports notif yChangedAlarm, trigger a 

notif yChangedAlarm with ps = Major; else a notif yClearAlarm and a notif yNewAlarm with ps 
= Major. 

3. At monitorGP interval 8, if the IRPAgent supports notif yChangedAlarm, trigger a 

notif yChangedAlarm with ps = Minor; else a notif yClearAlarm and a notif yNewAlarm with ps 
= Minor. 

4. At monitorGP interval 15, trigger a notif yClearedAlarm clearing the last emitted Minor alarm. 



Thresholding behavior for direction Increasing for Gauge type PMAttribute 




1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

Threshold Granularity Period time intervals 



Figure B.3.1 
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B.3.2 Example 2 

Figure B.3.2 illustrates another multi-level thresholdSeverity thresholding behaviour for IRPAgent supporting 
notif yChangedAlarm. The horizontal axis indicates the time intervals specified by the GP. The vertical axis 
indicates the monitored measurementType values. The measurementType of this example is of type gauge. The 
Monitor . direction is set to "Decreasing". 

Further suppose that the measurementType is monitored for a two-level thresholdSeverity (a) threshold-crossing or (b) 
threshold reaching. (See 6.3.8.1 for clarification of the alternatives (a) and (b)) 

The threshold for the major-level thresholdSeverity is set to 7 with a hysteresis high and low levels set to 6 and 8 
respectively. 

The threshold for the minor-level thresholdSeverity is set to 9 with a hysteresis high and low levels set to 8 and 10 
respectively. 

The performance alarm triggering events are: 

1. At monitorGP interval 1, trigger a notif yNewAlarm with ps = Major. See table B.l table for transition 
State-0 to State-2. 

2. At monitorGP interval 5, trigger a notif yChangedAlarm with ps = Minor. See table B.l for transition 
State-2 to State- 1. 

3. At monitorGP interval 8, trigger a notif yChangedAlarm with ps = Major. See table B.l for transition 
State- 1 to State-2. 



Thresholding behavior for direction Decreasing for Gauge type PIVIAttribute 




^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 

Threshold Granularity Period time intervals 



Figure B.3.2 
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B.3.3 Example 3 

Figure B.3.3 illustrates a single-level thresholding behaviour. The horizontal axis indicates the time intervals specified 
by the monitorGP. The vertical axis indicates the monitored measurementType values. The measurementType of this 
example is of type gauge. The Monitor . direction is set to "Increasing". 

The threshold is set to 4 with a hysteresis high and low levels set to 5 and 3 respectively. The thresholdSeverity level is 
Critical. 

The performance alarm triggering events are: 

1 . At monitorGP interval 3, trigger a not i f yNewAlarm with ps = Critical. 

2. At monitorGP interval 11, trigger a not if yClearedAlarm with ps = Cleared. 

Hysteresis at 4 with high and low 




Threshold granularity period time intervals 



Figure B.3.3 
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